Scenario #4306: Settle Members Debt with Coop Assets Via Clearing

Properties

Required

Given

name value
memberNumber M-3101000
reference cancel 2024-01-15
valueToClear 128
comment clearing according to members debt
transactionDate 2024-02-15

Find membershipUuid

HTTP GET "/api/hs/office/memberships/M-3101000" \
  -H "Authorization: Bearer $HSADMINNG_JWT_BEARER" \
  `# {` \
  `#   "sub" : "uuid<hsh-alex_superuser>"` \
  `# }`
=> status: 200 OK 
{
  "uuid" : "640248e3-8ae0-4f09-87a2-1fed91a6eb2c", // Membership: M-3101000 - Test AG
  "partner" : {
    "uuid" : "17f118e3-af4e-44b2-a512-6a2a331570a4", // Partner: P-31010 - Test AG
    "partnerNumber" : "P-31010",
    "partnerRel" : {
      "uuid" : "22b0c1b5-5b3b-4cd1-8c56-464f71deeac3", // partnerRelationUuid
      "anchor" : {
        "uuid" : "882bda1d-4e5e-42f8-afdd-b9741d1c1f4e", // Person: Hostsharing eG
        "personType" : "LEGAL_PERSON",
        "tradeName" : "Hostsharing eG",
        "salutation" : null,
        "title" : null,
        "givenName" : null,
        "familyName" : null
      },
      "holder" : {
        "uuid" : "9e12338f-c1ea-4237-9d64-f085a84850c6", // Person: Test AG
        "personType" : "LEGAL_PERSON",
        "tradeName" : "Test AG",
        "salutation" : null,
        "title" : null,
        "givenName" : null,
        "familyName" : null
      },
      "type" : "PARTNER",
      "mark" : null,
      "contact" : {
        "uuid" : "eef1dec6-8687-4615-91ae-3fbbcc48dd34", // Contact: Test AG - China
        "caption" : "Test AG - China",
        "postalAddress" : {
          "country" : "China",
          "province" : "Guangdong Province",
          "city" : "Dongguan City",
          "street" : "No.2 Commercial Second Street",
          "district" : "Niushan Wei Wu",
          "department" : "Executive Board",
          "building" : "Thi Chi Koh Building"
        },
        "emailAddresses" : {
          "main" : "norden@test-ag.example.org"
        },
        "phoneNumbers" : {
          "phone" : "++15 999 654321"
        }
      }
    },
    "details" : {
      "uuid" : "2afc94e0-29c7-4396-8e96-fbb46213e0fa",
      "registrationOffice" : "Registergericht Hamburg",
      "registrationNumber" : "1234567",
      "birthName" : null,
      "birthPlace" : null,
      "birthday" : null,
      "dateOfDeath" : null
    }
  },
  "mainDebitor" : null,
  "memberNumber" : "M-3101000",
  "memberNumberSuffix" : "00",
  "validFrom" : "2020-10-15",
  "validTo" : "2023-12-31",
  "status" : "CANCELLED",
  "membershipFeeBillable" : true
}

Create the Coop-Assets-CLEARING Transaction

HTTP POST "/api/hs/office/coopassetstransactions" \
  -H "Authorization: Bearer $HSADMINNG_JWT_BEARER" \
  `# {` \
  `#   "sub" : "uuid<hsh-alex_superuser>"` \
  `# }` \
  <<EOF
{
  "membership.uuid" : "640248e3-8ae0-4f09-87a2-1fed91a6eb2c", // Membership: M-3101000 - Test AG
  "transactionType" : "CLEARING",
  "reference" : "cancel 2024-01-15",
  "assetValue" : "-128",
  "comment" : "clearing according to members debt",
  "valueDate" : "2024-02-15"
}
EOF
=> status: 201 CREATED 7bf86cb4-dc79-4ee6-bcb5-edb695e0ae77

Verify Coop-Assets CLEARING-Transaction

HTTP GET "/api/hs/office/coopassetstransactions/7bf86cb4-dc79-4ee6-bcb5-edb695e0ae77" \
  -H "Authorization: Bearer $HSADMINNG_JWT_BEARER" \
  `# {` \
  `#   "sub" : "uuid<hsh-alex_superuser>"` \
  `# }`
=> status: 200 OK 
{
  "uuid" : "7bf86cb4-dc79-4ee6-bcb5-edb695e0ae77",
  "membership.uuid" : "640248e3-8ae0-4f09-87a2-1fed91a6eb2c", // Membership: M-3101000 - Test AG
  "membership.memberNumber" : "M-3101000",
  "transactionType" : "CLEARING",
  "assetValue" : -128,
  "valueDate" : "2024-02-15",
  "reference" : "cancel 2024-01-15",
  "comment" : "clearing according to members debt",
  "adoptionAssetTx" : null,
  "transferAssetTx" : null,
  "revertedAssetTx" : null,
  "reversalAssetTx" : null
}

generated on 2026-08-10 04:34:23 for branch HEAD